Programming with QuickTime VR

| Previous | Chapter contents | Chapter top | Section top | Next |

QTVRMouseWithin

You can use the QTVRMouseWithin function to handle the user's leaving the cursor in a QuickTime VR movie for which mouse-over tracking is disabled.

OSErr QTVRMouseWithin (QTVRInstance qtvr, Pointpt, UInt32*hotSpotID, WindowPtr w);
qtvr
An instance of a QuickTime VR movie.
pt
The current location of the cursor, in the local coordinates of the graphics world specified by the w parameter.
hotSpotID
On entry, a pointer to a long integer. On exit, that long integer contains the ID of the hot spot that lies beneath the specified point, or the value 0 if no hot spot lies beneath that point.
w
A pointer to a graphics world.
function result
A result code.

DESCRIPTION

The QTVRMouseWithin function returns, in the long integer pointed to by the hotSpotID parameter, the ID of the hot spot in the QuickTime VR movie specified by the qtvr parameter that lies directly under the point specified by the pt parameter. If no hot spot lies under that point, the long integer is set to 0. QTVRMouseWithin also performs any other tasks that are typically performed when the user leaves the cursor in a QuickTime VR movie.

You should call QTVRMouseWithin repeatedly for as long as the cursor remains in the specified QuickTime VR movie.

SPECIAL CONSIDERATIONS

You need to call QTVRMouseWithin only if you have disabled mouse-over tracking for the specified QuickTime VR movie.

SEE ALSO

Use QTVRSetMouseOverTracking (link) to change the mouse-over tracking state of a QuickTime VR movie. Use QTVRMouseEnter (link) and QTVRMouseLeave (next) to handle the cursor's entering and leaving a QuickTime VR movie.

© 1997 Apple Computer, Inc.

| Previous | Chapter contents | Chapter top | Section top | Next |